home *** CD-ROM | disk | FTP | other *** search
/ Amiga Tools 4 / Amiga Tools 4.iso / tools / internet-tools / nntpkick13 / readme < prev   
Encoding:
Text File  |  1996-02-26  |  6.2 KB  |  168 lines
  1. NNTPKick - Another pounding Blender Software (BS) production
  2. ------------------------------------------------------------
  3.  
  4. This is a client for AmigaNOS that posts Usenet articles to a NNTP server.
  5.  
  6. I couldn't get AmigaNOS' built-in NNTP poster to work and Demon Internet's
  7. mail2news gateway messes around with the headers something chronic and it
  8. can't cope with 8 bit characters (because it's mail). So I wrote this.
  9.  
  10.  
  11. What you need
  12. -------------
  13.  
  14. Kickstart 2 or above and Graham Walter's version of AmigaNOS (I'm using GW6,
  15. I don't know if earlier versions will work).
  16.  
  17. You also need ARexx running if you want to use the UUCP to AmigaNOS script.
  18.  
  19.  
  20. Installing
  21. ----------
  22.  
  23. Copy NNTPKick to the TCPIP:Clients drawer.
  24.  
  25. In your TCPIP:NOS-Startup file (towards the end), put 'client nntpkick'. You
  26. might want to set up the options, look down a bit for that.
  27.  
  28. Make the directory TCPIP:Spool/Nqueue. This is a directory which holds
  29. spooled articles, like TCPIP:Spool/Mqueue does for mail.
  30.  
  31. Get your news articles into Nqueue before you use AmigaNOS to dial up your
  32. Internet provider. It depends on your set up how you do this...
  33.  
  34. If you use an AmigaNOS/UUCP/Demon Internet set up then make a file called
  35. UULIB:sitename. This is a single line that holds your full site name, mine's
  36. 'blender.demon.co.uk'. Then copy the ARexx script NNTPPost to wherever you
  37. want and mark it as a script by typing 'protect NNTPPost srwd'. Now just run
  38. the script before dialing up and you're sorted. With DIS3, if you alter
  39. 'newspost' in DIS:C/Newsreader to 'nntppost' then everything's as automatic
  40. as it was before. Protect DIS:C/Newsreader srwd after editing it.
  41.  
  42. If you run an AmigaNOS/UUCP setup but not with Demon then do the same, but
  43. change the 'batchfile' variable at the top of the script to whatever yours
  44. is called and re-protect srwd it if you need to.
  45.  
  46. If you use AmigaNOS without UUCP then put the line 'assign UULIB: S:' in your
  47. User-Startup, make the file S:sitename, and sort out yourself how to get your
  48. articles into Nqueue (the hints at the end will probably help).
  49.  
  50. The ARexx script needs the Tail command in either C: or the same directory as
  51. NNTPPost. If you've already got it then you might still need to use this one.
  52. Some versions of Tail can't cope with long lines, which means that some
  53. postings might not get out.
  54.  
  55.  
  56. Options
  57. -------
  58.  
  59. From the shell:    NNTPKick SERVER,DIR=DIRECTORY/K,IHAVE/S,POST/S
  60. From AmigaNOS:    client "NNTPKick SERVER,DIR=DIRECTORY/K,IHAVE/S,POST/S"
  61.  
  62. - SERVER
  63.   The news server to post the articles to. If you don't give a server then
  64.   it looks in TCPIP:Spool/News/nntp.dat and uses the one in there.
  65.  
  66. - DIR=DIRECTORY/K
  67.   The directory for the news spool. Defaults to TCPIP:Spool/Nqueue.
  68.  
  69. - IHAVE/S
  70.   Ignore any 'posting denied' message given by the news server once NNTPKick
  71.   is connected (instead of disconnecting immediately). The reason is that
  72.   some servers say that posting is denied through the POST command but still
  73.   allow postings through the IHAVE command (which is the default for this
  74.   program). Try this if NNTPKick with no options doesn't work.
  75.  
  76. - POST/S
  77.   Use the POST command instead of the IHAVE command (which is the default)
  78.   for posting articles. Try this if NNTPKick with no options doesn't work and
  79.   NNTPKick with the IHAVE option doesn't work.
  80.  
  81.  
  82. Hints and tips
  83. --------------
  84.  
  85. When you use NNTPKick from the command session window (or TCPIP:NOS-Startup),
  86. the quotes are important unless you're just using 'client nntpkick' with no
  87. options where you can get away with leaving them out.
  88.  
  89. If there's a problem at the server (eg. the server's busy) you can use
  90. 'client nntpkick' from the command session window to start it up again (use
  91. FKey to speed up typing).
  92.  
  93. Or you could tell NNTPKick to use a different, less busy, server. For Demon
  94. people you can use distort.demon.co.uk instead of news.demon.co.uk, so you'd
  95. use 'client "nntpkick distort.demon.co.uk"' from the command session window
  96. (or TCPIP:NOS-Startup).
  97.  
  98. If there's a posting failure, the .wrk file is deleted but the .txt file is
  99. left behind in SLIP:Spool/Nqueue. Only a .txt/.wrk pair is posted, .txt files
  100. on their own are ignored. You can try to post it again if you want by making
  101. the .wrk file again.
  102.  
  103.  
  104. Techy stuff
  105. -----------
  106.  
  107. - Format of Nqueue.
  108.  
  109.   Each article spooled in Nqueue is held in two files...
  110.  
  111.     filename.txt
  112.     filename.wrk
  113.  
  114.   Also there is a third file...
  115.  
  116.     filename.lck
  117.  
  118.   If you make a file called this (it doesn't matter what it holds, so it may
  119.   as well be empty) then NNTPKick won't even look at the .txt and .wrk files.
  120.   So the script that spools the article to Nqueue has to make this file
  121.   first, then make the .txt and .wrk files, then delete the .lck file.
  122.   Otherwise if you're on-line NNTPKick could try to post half-spooled files.
  123.  
  124. - Format of filename.txt.
  125.  
  126.   Filename.txt holds the news article. It should have the following headers
  127.   at least (it doesn't matter about the order)...
  128.  
  129.   From: <username>@<sitename> (Real Name)
  130.   Date: Day, DD Mon YYYY HH:MM:SS TIMEZONE
  131.   Newsgroups: <newsgroups>
  132.   Subject: <subject>
  133.   Message-Id: <message-id@sitename>
  134.   Path: <sitename!username>
  135.  
  136.   If you use a UUCP setup then PostNews and NNTPPost do everything you need
  137.   automatically so you don't have to bother checking anything. If you don't
  138.   then you've got to sort everything out yourself.
  139.  
  140. - Format of filename.wrk.
  141.  
  142.   Filename.wrk file holds the article's message ID on a single line. It
  143.   mustn't hold the header and it must have the angled brackets...
  144.  
  145.   <dan.0001@blender.demon.co.uk>
  146.  
  147.  
  148. Boring wibble
  149. -------------
  150.  
  151. Apart from the Tail command, it's copyrighted by me but freely distributible.
  152. It shouldn't be altered in any way and you should only charge for disks,
  153. postage, or packing if you charge anything.
  154.  
  155. If you lose news then I can't be held responsible lost news or anything else
  156. going wrong - you use this program at your own risk. After all, it's free -
  157. what more do you want? But I trust it enough to use it.
  158.  
  159. And it can't be used as part of anything that's sold for profit without my
  160. say so, although the chances of that are fairly remote, I think.
  161.  
  162. My Email address is dan@blender.demon.co.uk, if you spot a bug or something.
  163.  
  164. Actually I'm closing my Demon account fairly soon. If you get a bounce or
  165. no reply, try CM-D.J.Cannon@tees.ac.uk instead.
  166.  
  167. Dan.
  168.